home *** CD-ROM | disk | FTP | other *** search
Text File | 1994-12-07 | 8.7 KB | 8 lines | [ ONLN/HLX2]
Sample ComponentsPeter Hoddie©1992 Apple Computer, Inc.This unnamed collection of sample code provides six different sample components which show how you can extend QuickTime. Taken as a whole, they provide a complete example of how to add your own fully supported data type to QuickTime.This sample Derived Media Handler overrides portions of the Base Media Handler to provide a new QuickTime Media Handler which uses QuickDraw Pictures as its samples. Every frame added to a PICT track is a QuickDraw Picture. This is particularly convenient for sample code, since all that is required to draw the image is a call to DrawPicture.The easiest way to create a movie that contains a track which uses the PICT Media Handler is to use the Movie Import Component (described below) to convert your Scrapbook file into a QuickTime movie. The sample Movie Import Component allows you to convert all of the PICT images in a Scrapbook file into a QuickTime movie that uses the PICT Media Handler.To use the Movie Import Component, check out the ImportExportMovie sample code and application also on this QuickTime 1.5 CD. You can also use it from the Standard File Preview dialog in most applications that open movies.The sample Movie Export Component takes a PICT Media Handler track and converts it to a PICS file. Because the samples in a PICT Track are simply QuickDraw Pictures, this process is trivial.To use the Movie Export Component, check out the ImportExportMovie sample code and application also on this QuickTime 1.5 CD.The sample File Preview Component displays previews for PICS files. QuickTime 1.5 contains a PICS Movie Import Component, but no PICS File Preview Component. It would be trivial to modify this component so that you could preview Scrapbook files (which would compliment the Movie Import Component sample code nicely).To use the File Preview Component simply use Standard File Preview to open a movie (in MoviePlayer, for example). PICS files are shown automatically (because QuickTime contains a PICS MovieImport Component). You will be able to preview them from the dialog now.The sample Sequence Grab Channel Component captures a PICT Track. It captures the image from the area surrounding the current cursor position on the main screen. This is by far the most complex piece of sample code. It shows everything necessary to add the ability to capture new types of data to QuickTime.There is no terribly easy way to use the Sequence Grab Channel Component, short of modifiying the Hack TV sample application on this disk to let you create a PICT grab channel.The sample Sequence Grab Panel Component implements a panel for the PICT Sequence Grab Channel. The panel lets you configure the one option of the PICT Sequence Grab Channel - whether or not it displays the current value of Ticks in the image.Again, there is no terribly easy way to use the Sequence Grab Panel Component, short of modifiying the Hack TV sample application.An MPW make file has been provided for these sample components. Also, a complete build of the sample components is also provided. You can drop it into your Extensions Folder, reboot, and start using some of the Component immediately.Note that these sample Components are meant to be instructive. They are not intended to be the basis of a real product. Furthermore, they only perform limited error checking. For more details on these component types, please see the apporpriate chapter in the QuickTime Components documentation.Ê ◊# ˇ ˇˇˇˇ # ◊ _ , Times . ° d ONLN d ) æ <e +‹VSample Components ° d ONLN d ; Ú G0 +4 Peter Hoddie ° d ONLN d G À SW ( o È©1992 Apple Computer, Inc. ° d ONLN d ; _ < k· ( á ZUThis unnamed collection of sample code provides six different sample components which ° d ONLN d ë k < wø * Lshow how you can extend QuickTime. Taken as a whole, they provide a complete ° d ONLN d fi w < Éò * Fexample of how to add your own fully supported data type to QuickTime. ° d ONLN d% è < õ x * This sample ° d ONLN d1 è x õ ˚ )<Derived Media Handler ° d ONLN dF è ˚ õ· )É0 overrides portions of the Base Media Handler to ° d ONLN dw õ < ß· ( √ ZSprovide a new QuickTime Media Handler which uses QuickDraw Pictures as its samples. ° d ONLN dÀ ß < ≥ * YEvery frame added to a PICT track is a QuickDraw Picture. This is particularly convenient ° d ONLN d% ≥ < ø» * Wfor sample code, since all that is required to draw the image is a call to DrawPicture. ° d ONLN d} À < ◊ø *QThe easiest way to create a movie that contains a track which uses the PICT Media ° d ONLN dœ ◊ < „æ * NHandler is to use the Movie Import Component (described below) to convert your ° d ONLN d „ < Ô ˘ * &Scrapbook file into a QuickTime movie. ° d ONLN dF ˚ < u * The sample ° d ONLN dQ ˚ u )9Movie Import Component ° d ONLN dg ˚‹ )ë- allows you to convert all of the PICT images ° d ONLN dï <∞ (/ ZLin a Scrapbook file into a QuickTime movie that uses the PICT Media Handler. ° d ONLN d„ <+ ± *To use the Movie Import ° d ONLN d˙ ±+ µ )u ° d ONLN d˚ µ+„ ):Component, check out the ImportExportMovie sample code and ° d ONLN d6+ <7“ (S ZUapplication also on this QuickTime 1.5 CD. You can also use it from the Standard File ° d ONLN då7 <C; * 5Preview dialog in most applications that open movies. ° d ONLN d¬O <[ u * The sample ° d ONLN dÕO u[ )9Movie Export Component ° d ONLN d„O[Ω )ë% takes a PICT Media Handler track and ° d ONLN d [ <g‘ (É ZTconverts it to a PICS file. Because the samples in a PICT Track are simply QuickDraw ° d ONLN d^g <s Œ * "Pictures, this process is trivial. ° d ONLN dÇ <ã‚ *RTo use the Movie Export Component, check out the ImportExportMovie sample code and ° d ONLN d’ã <ó * *application also on this QuickTime 1.5 CD. ° d ONLN d £ <Ø u * The sample ° d ONLN d £ uØ )9File Preview Component ° d ONLN d!£ØŸ )å, displays previews for PICS files. QuickTime ° d ONLN dNØ <ª‚ (◊ ZR1.5 contains a PICS Movie Import Component, but no PICS File Preview Component. It ° d ONLN d°ª <«Ã * Swould be trivial to modify this component so that you could preview Scrapbook files ° d ONLN dı« <”Æ * H(which would compliment the Movie Import Component sample code nicely). ° d ONLN d>fl <ÎÊ *VTo use the File Preview Component simply use Standard File Preview to open a movie (in ° d ONLN dïÎ <˜À * PMoviePlayer, for example). PICS files are shown automatically (because QuickTime ° d ONLN dʘ <’ * Qcontains a PICS MovieImport Component). You will be able to preview them from the ° d ONLN d8 < u * dialog now. ° d ONLN dD <' u * The sample ° d ONLN dO u'@ )9 Sequence Grab Channel Component ° d ONLN dn@' )À# captures a PICT Track. It captures ° d ONLN dí' <3› (O ZXthe image from the area surrounding the current cursor position on the main screen. This ° d ONLN dÎ3 <? * Yis by far the most complex piece of sample code. It shows everything necessary to add the ° d ONLN d E? <K' * 2ability to capture new types of data to QuickTime. ° d ONLN d xW <c– *RThere is no terribly easy way to use the Sequence Grab Channel Component, short of ° d ONLN d Àc <oÕ * Tmodifiying the Hack TV sample application on this disk to let you create a PICT grab ° d ONLN d o <{ d * channel. ° d ONLN d )á <ì u * The sample ° d ONLN d 4á uì1 )9 Sequence Grab Panel Component ° d ONLN d Qá1ìÕ )º implements a panel for the PICT ° d ONLN d rì <üº (ª ZNSequence Grab Channel. The panel lets you configure the one option of the PICT ˇb ◊# ˇ ˇˇˇˇ # ◊ _ , Times . ° d ONLN d ) < 5» +ZQTSequence Grab Channel - whether or not it displays the current value of Ticks in the ° d ONLN d U 5 < A \ * image. ° d ONLN d \ M < Y‚ *WAgain, there is no terribly easy way to use the Sequence Grab Panel Component, short of ° d ONLN d ¥ Y < e * *modifiying the Hack TV sample application. ° d ONLN d fl q < }“ *PAn MPW make file has been provided for these sample components. Also, a complete ° d ONLN d0 } < â’ * Ubuild of the sample components is also provided. You can drop it into your Extensions ° d ONLN dÜ â < ïÄ * BFolder, reboot, and start using some of the Component immediately. ° d ONLN d… ° < ≠‹ *WNote that these sample Components are meant to be instructive. They are not intended to ° d ONLN d! ≠ < π„ * Zbe the basis of a real product. Furthermore, they only perform limited error checking. For ° d ONLN d| π < ≈≥ * Pmore details on these component types, please see the apporpriate chapter in the ° d ONLN dÕ ≈ < — ˚ * #QuickTime Components documentation. ˇ 
